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First of all, thank vou for your patronage. I hope, and believe, that you 
will find Loader Y an exceptional value. Please read the entire documentation 
before making your working copy as there are several possible configurations! 
If you have any questions, or experience any problems that this documentation 
doesn't answer. please feel free to contact me. 


On 'Compuserve' - IDH 72676,2544 
or 


kurt A. Casby 
23 Battle Creek Court 
St. Paul, Mn. 55119 


Two Werz ions 


There are tuo versions of the machine code portion of Loader V on the tape you 
have. The ‘normal’ version will be loaded automatically when you first load 
Loader Y. This version allows loading the buffer with any normal 'Bytes:' 
file up to 27,256 bytes long, thus filling Mterm's buffer. This version also 
uses the entire memory of the computer, from the start of BASIC up, ‘and some 
below BASIC) when loading the buffer. Therefore, nothing else (except Mterm, 
of course) can be in this area of memory at the same time. 


The second version is an attempt to allow users who may have other RAM 
resident software (a DOS perhaps?) to use the program. This version leaves 
the memory from 49,8000 up untouched. Files loaded into the buffer with this 
version cannot exceed 19,936 bytes in length. This is not as severe a 
limitation as it may seem, it is still large enough to load any Tasuord II, or 
Mscript text file vou may wish to send! 

If you attempt to load the buffer with a file longer than the version you are 
using permits, you will get some possibly interesting, but most definitely 
undesirable results! 

Except for the size of the file you may load into the buffer, the two versions 
are identical. In fact, the BASIC portion of Loader Y is the same for both! 
Pl = a E e Pio tt = = 

TSZ OSS is a registered trademark of Timex Computer Corporation 

rit =e rm ie a copyrighted program of Micro-System Software, Inc. 

Mer irt is a copyrighted program of Micro-Systems Software, Inc. 


Tas agora II is a copyrighted program of Tasman Softuare 
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Stock Set -ur 
13 Load Mterm into your TS2068 «LOAD ""CODE>. 


2) Load Loader Y into your TS2068 (LOAD "">. The BASIC portion of the program 
will load, followed by the machine code. The loading process should terminate 
with the report! © OK, 99399:2. If vou desire to use the second version of 
the machine code, vou must no types LOAD "R" CODE, press ENTER, and play the 
tape until it loads. Be patient, you only have to do this once! 


2) Edit lines 190-119, inserting your favorite BBS names and numbers. Flease 
abide by the restrictions in the DATA statements. {No more than 17 letters in 
the name, and up to 11 digits in the telephone numbers.?> The numbers MUST be 
preceded by an upper case (capital) letter to specify what communication 
Parameters you wish to use with that number. You will note there is now a 
capital P (for parity!) in this position in each of the DATA statements. The 
letters have the following meanings! 

E - 7 bit word size, Even parity, 1 stop bit 

O - 7 bit word size, Odd parity, 1 stop bit. 

Anvthing else - 8 bit word size, No parity, 1 stop bit. 


4) Insert a blank tape into your recorder and type! RUN 9000. This will SAVE 
a working copy of Loader Y combined with Mterm! You may now, using this copy, 
load the whole works with one LOAD "". 


Mt Favorite 
1) Follow steps 1 thru 3 as above. 


2> Type RUN, then hit ENTER. You will now be looking at Loader V's Main Menu. 
Press 1, hit ENTER, and you will be at the ‘front page' of Mterm. 


2) Now load, or type in your favorite telephone numbers and macro Keys in the 
usual ay. I prefer to Keep only those telephone numbers which are almost 
never busy in my Mterm dialing list, since it does not repeat dial. 


4) Exit to BASIC. 


53 Type, in the immediate mode (without a line number?! FOR x=34066 TO 34088: 
POKE x,Bt NEXT x then press ENTER, This will modify Mterm so that it will 
not erase your telephone numbers and macro Keys every time you run it! Unlike 
so called ‘warm starts', this modification will not effect anything else! 


6) Edit line 20800, altering the length of Mterm (from VAL "7721" to VAL 
"9216". This is so your telephone numbers and macro keys will be saved with 
Mterm! > 

7) Insert a blank tape into your recorder, and type! RUN 939000, This will 
make a working copy of the whole works. Now you may load the entire set-up 
with one LOAD "*, and have a total of 34 telephone numbers available for 
dialing with only a few Key strokes! 
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Lls ing Loader ra 


After following the instructions on the previous page, using Loader V is a 
simple matter of selecting from menus. The main menu of Loader Y has three 
options: 


1 RUN MTERM 
2?) DIALING MENU 
3) LOAD BUFFER 


The FIRST option will run Mterm, just as if you had typed: PRINT USR 54016. 
When vou select this option you will see that there are some bytes used 
(BÚUFUSO? in the buffer. If you have loaded the buffer, 'BUFUSD' indicates how 
long the file you have loaded is. If you have not loaded the buffer, then 
this is the length of the BASIC portion of Loader V (without the variables!>., 
Tf you have not loaded the buffer, and you do not erase the buffer or download 
anything into it, you may exit to BASIC and type: RUN to use Loader V again. 


The SECOND option displays your additional dialing directory, and allous you 
to select a number to be dialed or enter a telephone number from the Keyboard. 
There is room for 28 names and numbers in this directory. When you use this 
feature, the number you select will be re-dialed automatically until you hit 
BREAK, or your call is answered. If your call is answered you will hear a 
BEEP, and then Loader V will run Mterm. Just hit ENTER twice to get into 
terminal mode, then do whatever the system you are calling requires. 


Lhen you enter a telephone number directly from the keyboard (option 'u' on 
the dialing menu? you may, if you wish, specify what communication parameters 
you want used for the call. You do this by preceding the number with an upper 
case (capital) letter. The meaning of these is the same as described in the 
"Stock Set-ur' instructions on the previous page. Tf vou type the number in 
without a preceding letter ‘unlike the DATA statements where you MUST precede 
the telephone number with a letter), Loader V will assume you want 8 bit word 
length, No parity, and 1 stop bit. (Most systems use these parameters, so 
most of the time you will not have to type in the letter!) 


When vou use the auto-repeat dialer, if the phone call you generate is 
answered (by a computer OR a human? the TS2852 modem will indicate a 
connection, and Loader VY will run Mterm. If you make a call, Loader Y runs 
Mterm. and as soon as you get to Mterm you see the message: ‘Connection lost', 
something other than a computer may have answered the phone! PLEASE check to 
make sure vou are dialing a telephone number that belongs to a computer! This 
Hill prevent you from accidentally dialing some poor soul's telephone number 
over and over, If you dial your own telephone number with the auto-repeat 
dialer. the TS28S8 modem will also indicate a connection, and Loader Y will 
run term. <I am not sure that I understand why you would want to call 
yourself when you are already on the phane!> 


The auto-repeat dialing routine has been extensively tested by myself, and 
several friends all around the country! It dials the telephone much faster 
than Mterm does, as you will no doubt notice! 


LL ORDER To" 


The THIRD option on the main menu allows you to load any standard 'Bytes:' 
format file into Merm's buffer if it will fit (27,256 Bytes). (IF what you 
want to send is longer, just save it in two parts, and send them one at a 
time!) You will first be prompted for a Filename. This is the name of the 
'Butest' vou wish to load. If you just press ENTER, the first 'Bytes!t' file 
on the tape will be selected. You will then be prompted for carriage return 
insertion. If you are sending a machine code program, choose option 19 None. 
If you are sending a text file, (from TASWORD II or MSCRIPT), then you may 
wish to have carriage returns inserted. You have a choice of after every 
line, or after every paragraph. Choose which ever is appropriate for the 
system vou will be sending to. (See the sections on using word processors for 
more information.) 


Lhen the load has been successful, the message: 'LOAD complete, press any Key' 
will be flashing near the bottom of the screen. If, after loading the buffer, 
vou do nat see this message, and instead find yourself at Loader V's main 
menu, there has been a loading error, or you pressed BREAK. Try again! 


If vou got the message ‘LOAD complete, press any Key', then press a Key and 
you will find yourself back at Loader V's main menu. You may now use the 
auta-repeat dialer, or RUN Mterm Cor change your mind and LOAD the buffer with 
some cather file!>. When you RUN Mterm or make a connection via the dialer you 
will find that the file you loaded is now in the buffer! 


Once you have loaded the buffer, and run Mterm, the BASIC portion of Loader Y 
will have been erased from memory (whatever you loaded the buffer with will 
overwrite this same area of the computer's memory!>, The machine code portion 
of Loader Y will still be safe in memory Cat 23780-24823) unless you type: 
MEW. So if vou completa your call and decide you wish to use Loader Y again, 
vou would only need to re-LOAD the BASIC portion (press BREAK after the BASIC 
has loaded and before the machine code starts to load? and type: DELETE 

9ee@e0 ,9499: RUN. If you wish to load the buffer again while you are still on 
line, vou should use Reloader to accomplish this! (See the documentation for 
Reloader for further information.) 


Lets Be Fair 


I hope you enjoy these programs, and find them a valuable addition to your 
softuare library! I welcome any comments, questions, or criticisms, 
preferably by mail, not Email. (My Compuserve budget is very limited!>. 


I honestly feel I have given anyone purchasing this program a fair deal. Many 
have told me that the programs are worth at least twice what I charge for 
them! I do not expect to get rich selling these programs, but I would not 
mind a fair return for the time and effort I have invested. If you make 
copies Cnot too difficult, I have explained how!) of these programs for other 
people, not only are you breaking the law, you are not being fair to mel 14 
you feel vou must make a copy for your friend, have vour friend send her or 
his name and address, along with $5.00 (or send it yourself!). This is about 
what I clear per copy. I will add your friends name to my customer list, and 
be willing to assist them in anyway I can. After all, fair is fair, right? 
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CTus=tomizaticor 


As Timex Sinclair enthusiasts. we all seem to enjoy altering and modifying our 
Programs ta suit our personal tastes! If you intend to alter Loader v, here 
are some things of which you should be aware: 


Memory space is critical for this program. Your modified version should not 
be longer than about 2025 bytes. (not including the lines that are DELETEd when 
it is loaded), assuming you do NOT create any new variables. This is only an 
approximation. If the program suddenly goes to the main menu when you are 
dialing, you have added too much ta the BASIC. The easiest way to Keep track 
of how long your modified version is getting to be, is to RUN it, then select 
'1> RUN MTERM' from the main menu. Look at 'BUFUSD', this is the length of 
your BASIC program (minus the variables)! 


If the BASIC looks odd, it is because it was written with memory conservation 
in mind. I suggest vou Keep it in mind if you make any changes! 


The ON-ERR statements should be left in the program. 
If vou need help in making alterations for a specific purpose, send me a 
letter, and I will try to help. Please be sure to specify exactly what 


goals) you are trying to achieve. 


Most people will find that the dialing routine works just fine the way it was 
delivered, and will have no need to alter it. Please try it BEFORE you start 


making changes! If you do have trouble with the dialer (wrong numbers, or 
incompletely dialed numberz?, your local telephone equipment may not be able 
to handle this increased dialing speed! You can still use the dialer by 


slowing it down a little! To do this, you will need to modify line #48 of the 
BASIC program, inserting a PAUSE statement so that the line looks like this! 


42 PAUSE VAL "25"! FOR d=i TO z! FOR esINT PI TO VAL "4": OUT m,e: 
PAUSE b: NEXT ef OUT m,i! OUT m,b! NEXT d: NEXT x 


If it still dials too fast for your telephone equipment you will have to 
experiment 4 little. Increase the length of the PAUSE statement you added 
from 'b' to 'PI', then to 'b+b' Cb is equal to 2). You may even need to 
increase the length of the first PAUSE statement in the line (try 281). Make 
the increases in small increments, and test each change. Even on the oldest 
phone equipment large increases will NOT be needed! 


If you feel that the dialing routine waits too long Cor mot long enough? for 
an answer before re-dialing the number, you can alter the VAL "ie3" in line 
#49. Try VAL "908" to shorten the wait, or VAL "1180" to lengthen it! 


Loader Y (either version) will peacefully co-exist with the Aerco patch for 
Mterm, PLEASE NOTE, however, that CIS-UP and TSXMODEM will not. The Aerco 
patch uses (as a printer buffer) the same area of memory that is used by both 
TSXMODEM, and CIS-UP. 


The version af this patch I have tested is, I believe, in the public domain. 
It was written by Dave Schoenwetter. 


Los Oe Fe => 


For those of vou whe may wish to experiment with Mterm. here is some further 
information and a partial memory map of Mterm! All addresses are in decimal. 


Loaded with Mterm: 


16 to 59221-Mterm's program code. 

2 to 594235-Deta for the Opening screen. 

36 to 59691-Data for the Main menu. 

39632 to 59255-Data for the Data menu. 

598586 to 6@183-Data for the System menu. 

69184 to 68372-Data for the Telephone entry menu. 
sa279 to 60540-Data for the Help menu. 

60541 to ERST4-Data for the Options (shift 9? menu. 
60575 to 61144-Data for misc. prompts. 

61145 to 61439-Mterm's variables stored here. 

61440 ta 61695—Mterm's Keyboard translation table. 
561696 to 6173E-More of Mterm's variables. (Last bytes loaded!>? 


Built when you RUN Mterm! 


61737 to 62378-Macro key list. (18 Macros, 64 bytes each!) 

62377 to 63174-Telephone number list. (14 numbers, 57 bytes each! 23 bytes 
for the name, 30 bytes for the number, 1 byte for the parity setting etc., 1 
byte for the selected Macro Key.) 


63175 to 63231-An empty 15th telephone number. (Used by Mterm if vou select a 
number from the list greater than 'N', you cannot use it!) 


63232 to 6393939-Your Display, Input, and Output translation tables. (3 tables, 
256 bytes each! In order D,I1,0.) 


64908 to 64767-Display screen 2, used when you print a screen. 
64768 to 65535-Display screen 1, used as main display screen. 


Mise. tidbits: 


s4066 to 54888-Builds the telephone directory and macro Key list. 
54089 to 54101-Builds the D,1,0 translation tables. 
6178@-Mterm's variable which controls the parity, word size, and stop bits the 
program will use. These are the values for the most common settings: 
79 =8,1.N 123:7,1,E 31 =7,1,0 


If vou have altered, or would like to alter your input, display, or output 
tables in Mterm, and would like Mterm to NOT re-create them each time you run 
it, then type, in the immediate made (without a line number): 


FOR <=54889 TO 54101: POKE x,8: NEXT x 


You must do this AFTER you have run Mterm, and loaded you favorite translation 
tables. You must also now save Mterm as 9984 bytes long, in order to save the 
translation tables along with it. This altered version can be used with the 
machine code version of Loader Y labeled "R". DO NOT ATTEMPT TO USE THIS 
MODIFIED VERSION OF MTERM WITH THE NORMAL VERSION OF LOADER vY MACHINE CODE! ! 
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Moving PHerm to a new type of mass storage device? The problem we have moving 
Mterm to these devices is not being able to load in telephone numbers and 
macro Keys from the new device. As outlined on page 2 C'My Favorite'>, you 
can save Mterm to your mass storage unit with your telephone numbers and macro 


Keys intact, altering Mterm so it will not erase them each tim you run it! 


Tf vou use several different telephone number and macro Key lists you can save 
them separately, and load them in when you wish! (The same is true for the 
tranzlatíon tables!) Load in your telephone list, or tables (from tape within 
Mterm>, exit to BASIC, and save the appropriate area of memory. For example, 
a telephone number and macro Key list would be saved as ‘CODE 61737,1435' on 
vour new device, Do this with each of your Lists. Then, when you want to 
load in a different list, exit to BASIC, and load the 'CODE' file of your 
choice in from your new device! 


File Transfers 


When vou upload (send) or download (received a file, you are engaging ina 
file transfer. To transfer any file, both of the computers involved must use 
an agreed upon 'protocal' Ca set of rules)! This protocol may be very simple, 


as in a non error checking ASCII “American Standard Code for Information 
Interchange)? file tranfer, or it may be relatively complex, as in an modem 
file transfer, 


Mterm provides vou with three variations of one protocol: REM, None, and HEX. 
CIS-UF is a fourth variation of this same non error checKing ASCII file 
transfer protocol. 


TSXMODEM provides vou with a second protocol, used by many computer systems, 
referred to as Xmodem. modem is an error checking file transfer protocol! 


Urload ins 


To upload (send) a file, you must first get the file into Mterm's buffer! If 
the file you want to send is a BASIC program, just load it in to your TSeg6s. 
If the file is anything else, use Loader Y to get it into Mterm's buffer. If 
what you sant to send is not a BASIC program or a 'Bytes:' file, then make it 
into a 'Bvtes!' file! For example, if you want to send a string array, CLEAR 
out all variables, and LOAD it in. Then FEEK the system variables 'VARS' and 
'ELINE' (zee page 263 in your manual) to find out where Cin memory) the array 
starts and ends. Then SAVE that area af memory as a CODE file (Bytes: 3! The 
receiver would have to SAVE the file as CODE (Bytesi2, DIM a similar string 
array, then LOAD the bytes in! 


Plesze note that if vou are sending the file to another TS2068, or to a system 
where it will be dounloaded by another TS2068 vou should never send a 
completely full buffer. elf vou doubt this, create such a file, load it into 
Mterm's buffer, RUN Mterm, and exit to BASIC! Your computer will have to be 
turned aff to regain control!> Keep uhat-vou send to no more than around 
26,500 bytes, and all should be fine! You can go up to 27,086, but the 
receiver will have to CLEAR 550809 before they will be able ta SAVE the file! 


= 
ES 
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Once vou have the file in Mterm's buffer, vou must choose an appropriate 
erotacol (or variation of a protocol) to use for the upload. The choice will 
depend on the contents af the file you wish to send, the system you are 
sending it to, and possibly on the computer that will later be downloading it 
from the system vou are sending the file to! 


The file vou want to upload may contain most anything your computer can create 
or use! This includes, but is not limited to: BASIC programs, Machine 
language programe, unformatted text files, formatted text files, a SCREENS 
file, data from a program such as Vu-Calc, the variables from a BASIC program, 
etc.. For the purpose of selecting an appropriate protocol you may divide the 
file contents into two catagories: 


iA formatted text file, CA file with nothing but text in it. No formatting 
commands, printer control codes, or anything other than the text itself!> For 
which vou may use Xmodem or non error checking (Mterm's None, Mterm's HEX, or 
CIS-UPF). Mr preferences, in order would be: modem, Merm's None, Mterm's 
HEM, and CIS-UP, 


2) Anything else. (That makes it easy, right?!!!> For which you may use 
¥Ymodem, or non error checking (Mterm's HEX, or CIS-UP>, My preferences, in 
order would be: “modem, Mterm's HEX, and CIS-UF. 


You must also take into consideration the capabilities of the system you are 
sending to. Remember, both systems must agree on the protocol before the file 
transfer can take place! You cannot use Xmodem if the computer you are 
sending to is not capable of using Xmodem. You cannot use Mterm's HEX 
variation if the system you are sending to has a maximum line length limit! 
¿That is why CIS-UP exists !> If you are using Mterm's None to send text, you 
must make sure that vour text file complies with any line length limit imposed 
by the system you are sending to. (See the sections on word processors.) 


Lhen you use any of Mterm's variations CHEX, None, or REM), to transmit a 
file, vou will be asked tuo questions by Mterm. The first question: 'TIi 
Prompt string ?' is asking you for the character string the ‘other' computer 


will be sending as a signal to send the next line! If you are sending toa 
system that prompts you for each line, tell Mterm what promet the other system 
will be using! If the system you are sending to will not be prompting you for 


each line, then just press ENTER. The second question: 'Tt Character delay 7' 
is asking vou to set the ‘throttle’. You may answer by just hitting ENTER 

(the same as answering with a @), or with a number from Ø to 255, followed by 
ENTER. The higher the number vou answer with, the slower Mterm will transmit 


the file. You will find that many BBS programs, and even some commercial 
systems cannot Keep up with a full speed transmission for more than 100-200 
characters. When vou send a file to one of these systems, you will need to 


eet the throttle! (Try between 59 and 75!) 


If vou are sending a file to another TS2MES, you can control the ‘other’ 
TSePes's buffer from your end. Send a ‘control r', this will open the buffer, 
then send the file, then send a ‘control t', this will close the buffer. 
(There is no need to do this if you are using TSXMODEM! > You must, of course, 
be careful while the ‘ather' TS2068'< buffer is open, to insure that you do 
not inadvertently send anything except the file! 
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Dounlcozading 


hen vou download (receive? a file, it will be placed in Mterm's buffer for 
YOU. You should make sure Mterm's buffer is empty before the dounload, or 
what vou receive may be added to what is already there! <If this is what you 
intend, then fine! ‘You should also take note af the size of the file you 
will be receiving, Keeping in mind that you should not fill your buffer 
completely! (See the comments under ‘Uploading'> To use any of Mterm's 
variations of the non error checking ASCII file transfer protocol you must 
open your buffer before the download, or have the sender open it for you if 
Possible. (You do not need to open the buffer when using TSXMODEM, see the 
separate documentation for more information.> 


Your choice of file transfer protocols may be dictated by the system that is 
sending the file, or by the person who uploaded the file to the system that is 
sending the file! If the file was uploaded to a third system “a BBS, 
Compuserve, etc.3, or will be sent from another TS2968 using CIS-UP or Mterm's 
HEX, vou will have to download with Mterm's HEX. If the file was uploaded to 
a third system, or will be sent from another TS2068 using Kmodem protocol, you 
will have to download using »modem protocol. If the file was uploaded to a 
third system using Mterm's None variation, you may still use Xmodem protocol 
for the download if this third system can use modem, and you so desire. If 
vou are receiving directly from another TS2068 using Mterm's None variation, 
vou will have to use it far the download also! 


Once you have the file in Mterm's buffer, you will have to SAVE it for later 
use! Make a note of hon many bytes (BUFUSD) have been used in Mterm's buffer, 
then exit to BASIC. If you downloaded a BASIC program, then type: SAVE 
"name". If what you downloaded was not a BASIC program, there may be lots of 
what looks like garbage on your screen. The reason for this is that your 
TS2068 is trying to interpret whatever you downloaded as a BASIC program 
(which it is not!)>, Fear mot, just type SAVE "name" CODE £E6710,C(the number 
of bytes CBUFUSO) used in Mterm's buffer.?>. This will save the file as a 
'Bytes:!:' file on your tape, The file being safely on tape Cor whatever mass 
storage you haved, the downloading process is now complete! 


Lio re d Processors 

Word processors are wonderful tools, deserving of the many books written about 
them. Our concern here, however, is limited to how we can best use them for 
creating text files for transmission via the modem, or viewing, altering, and 


printing cut text files we have received via the modem. 


There are two types of text files vou may wish to create for sending via the 


modems: unformatted, or formatted. An unformatted text file is useful only to 
someone with the same word processor, and possibly even the same printer and 
interface! Formatted text file are somewhat more universal, (See the 


definitions under ‘Uploading'.2 
If you want to create a formatted text file and upload it using Mterm's None 
variation of the non error checking ASCII file transfer protocol, you must 


Know something about the system you will be sending your text file to! 
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1) Most systems have a maximum line length. This means you must have a 
carriage return after each line, and each line must be less than the maximum 
acceptable length for the system you will be sending the file to. Even if you 
are sending to another TS2BES, where line length is not a consideration, you 
should have a carriage return after each line unless you Know for sure that 
the pereon on the other end has the same word processor you have. 


23 Some systems want carriage returns only at the end of each paragraph. If 
you are going to be sending the file to a system so designed, you must comply! 


3> Many systems will not allow a blank line (between paragraphs etc.), and 
same even interpret a blank line as the end of your file. If you will be 
sending your file ta a system such as this, you must comply. If the blank 
lines are important for the casmetic look of the text, try typing a single 
character Ca colon ':' perhaps?) at the beginning of any blank lines. This 
will be easily removed by anyone downloading your text! 


Within the limitations of these considerations, use the power of your word 
processor to create what you want to send! If you want your text to be easy 
to read on a 32 column screen, set your margins to 31! <The carriage return 
DOES take a space!) If vou want something centered between the margins, 
center it! Use your word processor to format the text as you want it to look 
when vou send it!!! 


When vou have downloaded a text file from another computer, your word 
processor is the ideal vehicle for viewing, editing, and printing out what you 
have downloaded. Using vour word processor, you may reformat the text to 
whatever margins you wish! You may alter, add to, or delete portions of the 
text. In short, you have complete control of the text file! There is no need 
to have pages and pages af text only half Cor less) the width of your paper 
just to have a hard copy of a small part of what you have downloaded! (The 
portion you really wanted!> 


Lis ing Tasword I I 


With Tasword II text files, the only real difference between a formatted and 
an unformatted text file is whether or not you have printer control codes in 
the file! This is because Tasword II does its ‘formatting’ as you type! For 
example, when you tell Tasuord IT to center something between the margins, 
Tasword II actually centers it on the line immediately. ‘This is not true for 
all word processors!) 


To create a formatted text file to send via the modem, you only need to make 

sure that there are no printer control codes imbedded in your text. Set your 
margins where you want them, right justify the text if you wish, and make the 
text appear the way vou want it to look when you send it! 


Tasword II does not, however, allow you to insert carriage returns in the 
text! Loader Y provides this option for Tasuord II users. If you choose to 
have carriage returns inserted, Loader Y will still respect yaur margins, 
justification, etc.. (Depending on the margins, this may alsa reduce the size 
of the text file, and, therefore the time it takes ta send it!) 
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If you have ever loaded a downloaded text file into Tasword Il, it may have 
looked very strange, full of garbage, and with no visable format at all! To 
work with such a file would be more difficult than retyping the whole thing! 
This is the reason I wrote Unloader. (See separate documentation.) After 
usina Unloader on the downloaded text file, you should easily be able to do 
whatever vou wish with it using Tasword II! 


Lit ins tas cr ipt 


To use Mscript with Loader V, or with text files downloaded with Mterm, you 
must hawe the 'Customized' version of Mecript! (This version allows you to 
save and load text files as normal ‘Bytes: ' files instead of the non standard 
method used by Mscript itself!) ‘Customized Mecript' adds many other useful 


features to the program as well! If you own Mscript, and do not have this 
version, you are missing the other half of your word processor! IT IS THAT 
GOOD! If vou don't have it, send a letter requesting ‘Customized Mecript' to! 


Jack Dohany 
325 O'Connor Street 
Menlo Park, CA. 94825 


You must send your name, address, and preferably your telephone number. You 
must e180 include a statement indicating that you do own Mscript, and let Jack 
Know what Kind Cand brand) of mass storage you are using! Jack also requests 
that you DO NOT send any money! 


To create a formatted text file to send via the modem, you may need to do some 


formatting yourself! If you want something centered between the margins, for 
example, vou must center it yourself. Remember, no formatting commands or 
Printer control codes in a formatted text file! You must also insert carriage 


returns in your file if you want them. This is not a big problem, if you want 
them after esch line, set your margins to what you desire, then move the 
cursar to the begining of the second line and hit ENTER. Then, just cursor 
down, hit ENTER, cursor down, hit ENTER, etc., until you get to the end of the 
file! 


As an alternate method for carriage return insertion, run the file through 
Unloader. Then when you load it into Mterm's buffer via Loader “Y, have Loader 
Y insert the carriage returns for you! 


With ‘Customized' Mscript, you can easily load text files you have downloaded 
with Mterm directly into Mscript as long as they are not too long! Some of 
the time, this will be entirely satisfactory. If, however, the file you have 
downloaded is too long for Mecript, or if you wish to get rid of the carriage 
returns after every line so you can alter the margins, then run the file 
through Unlosder! (See the separate documentation for Unloader.>) This will 
cut the file up into shorter files if needed, and will remove all the carriage 
returns, You should then reload each of the converted files back into Mterm's 
buffer with Loader Y, choosing to have carriage returns inserted after each 
Paragraph! Then save each of the files one more time! When you load these 
files into Mecript, you will have complete control over them, just as if you 
had typed them in. This is not as difficult as it sounds. Give it a try! 
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TSXMODEM is an auxiliary uploading and downloading routine for the TS2868 
computer, TS285A modem, and Mterm (Smart Term II>. It iz an implementation of 
Ward Christensen's Xmodem protocol! The Xmodem protocol is a public domain, 
error checking, file transfer protocol. I, along with thousands of other 
computer users, thank Mr. Christensen for his generous gift to us all! 


To use this routine, it must be loaded into memory (LOAD "TSXMODEM" CODE), and 
the computer vou will be sending to (or receiving from) must also be able to 
use Xmodem protocol! You then use Loader Y and Mterm to go on line as usual, 
however, vou MUST use 8 bits word length, No parity, and 1 stop bit as your 
communication parameters ! ¿This is required by the Xmodem protocol! Lhen 
the computer vou are sending to ‘Cor receiving from) is ready to receive (or 
send) the file, you exit to BASIC, and type! 


PRINT USF 24924 (To send - upload) 
PRINT USR 24415 (To receive - download) 
Then press ENTER! 


If you are sending (uploading?, then the routine will send whatever file you 
have in the buffer. Lhen the routine has finished its task, it will return to 
Mterm. 


If you are receiving (downloading) then whatever file is received will be 
Placed in the buffer. This will overwrite anything existing in the buffer ° 
prior to the dounload. It is a good idea ta make sure Mterm's buffer is 
closed before downloading à file. It will make no difference to the routine, 
but when vou return to Mterm after the routine has completed its task, you may 
inadvertentiy add some garbage to the end of the file if your buffer is open! 


If vou are used to sending and receiving files with Mterm's 'HEX' file 
transfer, or CIS-UP, this type of transfer will look a little strange! modem 
breaks the file into blocks of 12€ bytes each. The sender transmits a block, 
then a checksum to insure accuracy. All that will appear on your screen is a 
plus sign (+) for each good block sent (or received), or a minus sign (-? for 
each bad block. If a block was bad, it will be re-sent up to 18 times! (Some 
systems ' implementation of the protocol will give up easier, and earlier!) If 
after 19 tries, the block has still not made the trip intact, the receiver 
will 'give up'. This will seldom happen in the ‘real world’, but it is 
possible if the telephome lines are very bad! (Lots af Noise!). If one system 
gives up earlier than the other, the other will ‘time out', and give up also! 
You will be able to tell if your transfer was a success by watching the block 


symbols. When vou are downloading, if the buffer is empty (BUFUSD=B8) when you 
return ta Mterm, or if it contains the same number of bytes as before the 
dounload. the transfer failed! Failure is much less likely with Xmodem than 
with any other transfer method we have available to us! However, I thought 


you ought to Know what to look for! 
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The fact that not much is happening on your screen may make this type af 
transfer appear rather slon. In fact, it is almost twice as fast as a ‘HEX' 
file transfer! When vou transfer a file with the conversion set to HEX, the 
number of characters sent is actually twice the number in the file! This is a 
100 percent increase size of the file, and in the time the transfer takes. 
kmodem adds only a 4 percent increase! In addition, this protocol has been 
statistically proven to be approximately 99.9 percent effactive at error 
elimination!. This means that 999 times cut of 1908 your file will arrive 199 
percent correct! Twice as fast, and many times more accurate, what more could 
we ask for!!! 


Once vou upload er download a file from your TS28568 to another TS2068, a BBS, 
or a service like Compuserve using Xmodem protocol, you will really appreciate 
the speed and accuracy of Xmodem! Try it, you'll like it! 


I have installed a throttle in this routine so you may slow down the 
transmission if the computer you are sending to cannot Keep up with the full 
speed. It is unlikely that you will need this with Xmodem, since most systems 
are able ta Keep up with full speed for the length of a block! If you do need 
it, however, it is there for you to use. If you need to slow it down, POKE 
29212 with a number between 1 and 2535. The higher the number, the slower you 
30! 


To make a working copy of TEXMODEM for yourself, load it into your TS2068 from 
the side of the tape marked 'Loader V', insert a blank tape, and type! SAVE 
"TSXMODEM" CODE 24824,537 


If vou will be using this routine often, you can install it as a part of 
Loader Y. Just load it in when you make a working copy of Loader V, and edit 
ling 2200, changing the length of the code part of Loader Y from VAL "244" to 
VAL "781", 


Please also remember that all the machine code below 26714 (The start of 
BASIC? will be erased if you type: NEL. 


Please note that except for some minor relaxation of timing specifications (to 
allow the routine to work with services like Compuserve), this routine is pure 
Xmodem. It should work fine with ANY system that offers this protocol for 
file transfers. You should be aware, however, that some people have seen fit 
to 'improve' on this standard, altering the block size, or changing other 
spacifications. l believe this is counter-productive since the main value of 


a 'standard' is that it is the always the same! If you run across a BBS that 
will not transfer files with you using Xmodem, check with the SYSOP of the 
Bes. He, or she, has most likely ‘imeroved' on the protocol! 
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Unlosader is an file translation program for Mterm, Tasword II, and Mscript. 

It will convert a text file downlaaded into Mterm's buffer into one or more 

Tasword II text filecs>. It will also convert an Mscript text file into one 
or more Tasword II text filecs>! 


In order to be converted, the contents of Mterm's buffer must have already 
been saved. To do this, follow these steps: 


1) Make a note of how many bytes (BUFUSD> of Mterm's buffer have been used. 
2) At Mterm's main menu, press 'e', to exit to BASIC. 


3) Type, in the immediate mode Cwithout a line number): SAVE “name” CODE 
26716,“number of bytes used in buffer) 


After vou have saved the buffer contents in this manner, Unloader can 
translate them for you. Just LOAD 'Unloader', it will ask for the name of the 
file vou wish to translate. If you just press return, Unloader will select 
the first bytes on the tape! The actual conversion is done by the machine 
code in the REM statement at the start of the program. It is, therefore, very 
quick. 


After the conversion has been done, Unloader will ask for the name you want to 
save the converted file under. Type in the name, and press ENTER. Unloader 
will save the file on tape. 


Depending on a number of things, Unloader may create more than one file from 
the buffer file you loaded in! If more than one is needed, Unloader will 
flash ' More to Come! ' on the screen, then ask for the name of the second 
file. This process will continue until Unloader has finished its work. At 
that time, Unloader will print ' Finished ' on the screen, and will stop with 
a STOP statement. 


To make a working copy of Unloader, load it into your TS2868 from 'Side B' of 
the tape vou received, insert a blank tape, and typet RUN 3000. 
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Reloader is an auxiliary program for Loader Y, Because it relies on the 
machine code from Loader Y, this code must be in your computer when you use 
Reloader. Reloader's purpose is to allow you to load term's buffer while you 
are on line. 


14 vou have a 
several letter 
su in one session! You would first use Loader V to load the buffer with your 
first letter, get on line and send the letter. 


number of files vou wish to upload to some system, for example, 
s to send via easy-plex on Compuserve, Reloader allows you to do 


When vou are finished zending Your first letter, exit to BASIC from Mterm, 
LOAD "Reloader", then load your next letter into the buffer! If the file 
loaded properly, vou will see the message 'LOAD complete, press any Key! 
flashing near the bottom of the screen. Press a Key, and Reloader will RUN 
Merm, so vou may send the second letter! You may continue in this manner for 
2 many files as vou wish to send! CIF you do not see the message, and find 
yourself back at Reloader's menu, there was a loading error, or you pressed 
‘BREAK ' ! Try again!) 


55 


Reloader is most useful with a fast mass storage device (disk, microdrive, 
etc.) due to the loading times, but it will work fine with tape also! 


To make a working copy af Reloader, load it in from 'Side B' of the tape you 
received, insert a blank tape, then type! RUN 98008. 


Please also remember that all the machine code below 26718 «(The start of 
BASIC) will be erased if you type: NEW. 


Donated to the public domain! 
by 
Kurt A. Casby 


CIS-UP is an auxiliary uploading routine for the TS2068 computer, TS2B58 
modem. and Mterm (Smart Term 112. It allows HEX uploading to systems that 
have a fixed line length (like Compuserve). hHterm's HEX uploading routine 
does not respect any fixed line length, thus the need for this routine. 


Ta use the routine it must be loaded into memory (LOAD "CIS-UP" CODE. You 
then use Loader Y and Mterm to go om line as usual. then the computer you are 
sending to is ready to receive the file, you exit to BASIC, and type! PRINT 
USR 24624 then press ENTER. The routine will send what ever file you have in 
the buffer exactly like the 'HEX' mode in Mterm, except it will add a carriage 
return after each 62 characters! Lhen the routine has finished its task, it 
ill return to Mterm. 


If vou wish to set the line length ‘number of characters before a carriage 
return? to something other than 62, then POKE 24033 with a number 1/2 the 
length of the desired line! CIf you PRINT PEEK 24835 now you will see a 31, 
this is 1/2 of the line length of 62!) 


The routine is set up for 7 bits word length, Even parity, and 1 stop bit. If 
you want to use 8 bits word length, No parity, and 1 stop bit, then POKE from 
24994 to 24108 with As. Please note that the parity used by this routine MUST 
agree with the parity you are already using for the call! 359,127, 3 E 37 
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I have installed a throttle in the routine so you may slow down the 
transmission if the computer you are sending to cannot Keep up with the full 
speed. (Many BBS programs cannot handle full speed for more than 108 or so 
characters. After that, they lose some of the characters you send!), If you 
need to slow it down, POKE 24185 with a number between 1 and 255. <Most BBS 
Programs around here seem to need between 12 and 28!) 


To make a working copy of CIS-UP, load it into your TS2868 from the side of 
the tape marked ‘Loader W', insert a blank tape, and type! SAVE "CIS-UP" CODE 
24024,143 g 


If vou will be using this routine often, you can install it as a part of 
Loader Y. Just load it in when you make a working copy of Loader Y, and edit 
line 9898, changing the length of the code part of Loader Y from VAL "244" to 
VAL "393". 


Please also remember that all the machine code below 26718 <The start of 
BASIC? will be erased if you typet NEW. 


